.. _`Create Workspace`:

.. _`com.sympathyfordata.azure.powerbi.workspaces.create`:

Create Workspace
````````````````

.. image:: node_powerbi_workspace.svg
   :width: 48







Documentation
:::::::::::::

Creates a new :ref:`powerbi_workspace` with chosen name.

Duplicate workspace names are not allowed, so you must make sure to enter a
unique and unused name or select a fallback option (`When exists`) to
determine what happens if a workspace with the same name already exists.

:ref:`Propagates PowerBi input to output <powerbi_port>` with
the following changes:

    - Active workspace is set/replaced to the newly created or existing
      workspace.
    - Active dataset is cleared.


Definition
::::::::::


Input ports
...........

    **powerbi**  powerbi
        PowerBi


Output ports
............

    **powerbi**  powerbi
        PowerBi




Configuration
.............

    **When exists** (exists)
        Action when workspace name already exists
    **Workspace name** (name)
        Workspace name, required. It may not be empty







Examples
........

* :download:`BasicPowerBI.syx </Examples/Azure/PowerBi/BasicPowerBI.syx>`




Implementation
..............

.. automodule:: node_powerbi
    :noindex:

.. class:: CreateWorkspacePowerBi
    :noindex: